Software of the Month Club 1996 June

home *** CD-ROM | disk | FTP | other *** search

/ Software of the Month Club 1996 June / Software of the Month Club 1996 June.iso / pc / dos / biz / attend / readme.txt < prev next >

Wrap

Text File | 1996-01-16 | 28KB | 544 lines

╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ATTEND.EXE Employee Attendance Tracking Database Program ║ ║ Version 4.1a ║ ║ Copyright 1992, 1993, 1995, 1996 Robert J. Manning, author. ║ ║ Shareware version summary documentation 1/96 ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ Register your copy of ATTEND v4.1a and receive complete printed doc- ║ ║ umentation, the fully functional version of ATTEND, discounts on ║ ║ future upgrades, and discounts on custom versions for your business. ║ ║ ║ ║ Avoid future price increases! See the file REGISTER.TXT for a regist- ║ ║ ration form. Print out a copy, fill it in and mail today! ║ ║ ║ ║ Robert Manning, PO Box 2011, Lomita, CA 90717 USA ║ ║ ║ ║ Email: RobertM782@aol.com or 76022.1630@compuserve.com ║ ║ ║ ║ Visit the SBCA Web Page (includes a link to the authors' FTP site) at: ║ ║ http://users.aol.com/robertm782/private/sbcapage.htm ║ ╚═══════════════════════════════════════════════════════════════════════════╝ Topic: Line number: ────── ──────────── DOCUMENTATION AND REGISTRATION 47 ABOUT ATTEND 65 WHY ATTEND? 118 FILES IN SHAREWARE DISTRIBUTION 152 SAMPLE FILES 197 IMPORTANT 206 RUNNING THE PROGRAM 225 INSTALLING OVER PREVIOUS VERSIONS 233 BEFORE YOU BEGIN 251 THE PASSWORDS 276 THE IMPORT FUNCTION 286 THE TIMECLOCK FUNCTION 375 ANSWERS TO SOME OF YOUR QUESTIONS 398 REGISTRATION AND PRODUCT SUPPORT 445 WHAT YOU RECEIVE FOR REGISTERING 477 WHAT IF ATTEND DOESN'T MEET MY NEEDS? 492 WHAT ABOUT PROGRAM SUPPORT? 507 DOCUMENTATION AND REGISTRATION ══════════════════════════════ This is not the full documentation for ATTEND. It is only a summary of some important functions. Full documentation for the program is only provided to registered users. The complete document- ation includes a program walk-through, to demonstrate all major features of the program, as well as full details on all features. Some features of the program reserved for the registered version. Upon registration you will be sent a package containing your fully functional copy of the program, and the full printed manual for Attend, as well as a copy of the documentation in Windows Write format, your personalized Master Passcode, and will be eligible for full support and 50% discounts on future versions of Attend. Register ATTEND today for just $30.00 U.S.! ABOUT ATTEND ════════════ The short version: ────────────────── The program keeps a running record of attendance incidents, as well as vacation and sick leave. Excused and unexcused incidents can be recorded, and a running total of unexcused leave time is also shown. The program keeps a seperate dataset of imported incidents in the form of timeclock punches, and can be used to total time worked and calculate pay, if data is entered consistently. Time clock punches can be imported from an external program, or from the enclosed timeclock utility. Lengthy comment files can be kept on each employee for those really interesting excuses. The slightly longer version: ──────────────────────────── ATTEND is a single purpose Database program. It is designed to take away some of the trouble involved in finding and implementing an easy method of tracking and recording Employee attendance. It employs a combination of database and spreadsheet functions, to help format and track attendance. It can track approximately 200 employees per working directory, flags you when updates are due, computes statistics on employee leave occurrence types, as well as optionally storing employee personal information, allows use of extended comment files for making notes, and many other useful functions. Version 4.1a contains two completely new additional features: A TimeClock program, which will perform the various time clock tracking functions for recording actual work times, and an Import function, which can not only import and track data from the TimeClock program, but import ASCII text timeclock data to ATTEND from an external timeclock. The Import utility can also be used to total hours worked over time, and report the employees unadjusted pay. ATTEND can be run on any IBM compatible system, including the oldest systems. It requires DOS 3 or higher, and that's about it. It can be run in a text-window within Windows on a Pentium, or on a monochrome-screen XT. Version 3.4 and above can be run on a network, again using at least DOS 3.0. SHARE.EXE must be installed in order to do so. Version 3.5 and above use a 'Master Passcode' feature, intended for system administrators. It allows you to bypass the normal password (if it's in use), lock out normal password usage, and also allows you to change the normal pass-word. This feature has a hardcoded master passcode, which is unique for each registered copy. The ShareWare copy uses one non-unique passcode. The passcode for the ShareWare version is 4FP39QN6V. When you register your copy of ATTEND, your new registered copy will be embedded with a unique passcode, known only to the registrant. The screen saver enclosed can also be used on monochrome, EGA, or VGA screens (though the graphics routines will not work in a Window - use full screen mode for them). WHY ATTEND? ═══════════ ATTEND was created to fill a niche in business management, that of keeping an organized record of employee attendance. In todays' more competitive work environment, it has become more critical than ever to monitor employee work attendance habits, so that corrective measures can be taken, ensuring an employers' profit, and the employees' continued employment. The cost of employee attendance is often overlooked. It is easy to overlook those employees who arrive a few minutes late, leave a few minutes early, and do this on a continual basis. Consider a person making an hourly wage of $10, and suppose this person comes in just five minutes late every day, and leaves five minutes early. They might also take five extra minutes during their break, and another five if there's a second break period. That's twenty minutes a day. Whether the employee realizes it or not, they're costing both you and themselves money. In a week, this twenty minutes per day costs the employer $16.67, in a 4.3 week month $71.67, in a year $866.67! So, it costs the employer the equivalent of 1 and 2/3 hours per week in missed productivity. Multiply this by the number of employees, and the numbers can get large quickly. ATTEND can help you reduce this needless business cost. It can pay for itself in less than a month, by showing just one employee what their lax attendance is costing you. Version 4.1a of ATTEND can track the cost of employee attendance to at least one hundredth of an hour. The new TimeClock function can also reduce your workload spent tracking attendance, and the Import function can accept ASCII text clock punch files, for reduced time spent on data entry. And now with version 4.1a, you can use the program for tracking hours worked over any period in a calendar year, and calculate your employees unadjusted pay. FILES IN SHAREWARE DISTRIBUTION ═══════════════════════════════ This program may be freely distributed, provided that all files listed below are included with the program. The zipped archive file ATND41S.ZIP contains the following files: File Name: Type: ─────────── ────────────────── ATNDRUN.CFG Configuration file COLOR.CFG " " EXEMPT.CFG " " HOURLY.CFG " " OTHER.CFG " " SALARIED.CFG " " TCRUN.CFG " " TEMPEMPL.CFG " " FILE_ID.DIZ Description In Zip file ATNRST.EXE Utility executable ATTEND.EXE Main program executable GRPUPDT.EXE Utility executable IMPORT.EXE " " IP1.EXE " " MASTRSRT.EXE " " RUNCONFG.EXE " " SAVERSXA.EXE " " STATCFG.EXE " " TIMECLOK.EXE " " VIEWER.EXE " " ATTEND.ICO Windows Icon ATTEND.PIF Windows program information file DESCRIPT.TXT Program description text file README.TXT Program information text file REGISTER.TXT Registration form text file SAVEDELA.Y Configuration file SAMPLES.ZIP Contains sample employee files and their related configuration files. Take care not to over-write your existing master files with these. If in doubt, unzip to a test directory first. If for some reason you are missing one or more of these files, please feel free to contact the author by Email, and a replacement will be provided by Email (This service available only by Email). Please mention where you obtained the program. SAMPLE FILES ════════════ Some sample files are included with version 4.1a. These files allow you to explore Attend quickly. There are five files, each of them use similar names; The employee Badge/ID#'s are Sample1, Sample2, Sample3, Sample4, and Sample5, one of each status type. Sample1's file has had more records added to it, and a larger comment file, so you can take a look at what Attend can do. IMPORTANT: ────────── These sample files are enclosed in the file SAMPLES.ZIP. Be careful if you are installing this version over an older one, as this file contains a master tracking file and configuration files for the utilities! DO NOT OVER-WRITE YOUR EXISTING FILES WITH ANY OF THESE, OR YOUR DATA WILL BE LOST! If you don't have a previous installation of Attend, no problem. You will need PKUNZIP version 2.04g or better to unzip this file. These sample files are all set up to run on each of Attend's util- ities as well; You can experiment with punching the Timeclock for Sample1 for example, or search the Import dataset on another file to see how it works. Once you are comfortable with what Attend can do, and before starting data entry, you may wish to delete these files from Attend, or reinstall the program to a fresh directory. RUNNING THE PROGRAM ═══════════════════ To run the program, type in ATTEND and press Enter. To set ATTEND up to be run from within Windows, please refer to your Windows documentation for setting up a new program item. Keep in mind that the present password is set to BOB, and that the master passcode for the shareware version is 4FP39QN6V. INSTALLING OVER PREVIOUS VERSIONS ═════════════════════════════════ If you have a previous version of the program, please do not directly install this version over your previous copy. You must take care not to over- write your configuration files: EXEMPT.CFG HOURLY.CFG OTHER.CFG SALARIED.CFG TEMPEMPL.CFG You can over write these files, but then you will have to re-enter your employee status configurations. Please over-write all other files, with the exception of the files contained in SAMPLES.ZIP. See section above on the 'Sample Files'. BEFORE YOU BEGIN ════════════════ Before you begin Data entry to ATTEND, it would be wise to review the Employee Status Type configurations. Assure that the configuration adheres to your Company policy before continuing. This configuration sets the number of hours of Vacation and Sick leave to grant upon Anniversary. For more frequent updating of Vacation or Sick leave, there is a Mass Update function which can update employees in groups of status type, length of employment, or all employees. Assure that your systems' Date is correct. ATTEND makes use of your computers' internal Date to perform searches and updates. Incorrect Date may produce undesirable results. Date and Time may be set from within ATTEND. Attend contains many features divided into related groups. It will take some time to discover what the program can do. Use a copy of Attend along with the sample files to experiment with the program - this will keep you from learning the data entry part before actually using the program. You'll find that once set up, Attend is fairly easy to use. The program is being updated and improved all the time, and your questions and suggestions are most valuable in improving the program. Feel free to send an Email to the author at any time. THE PASSWORDS ═════════════ Password protection can be enabled; please write the password down in a safe place before using the function. The current password is set to BOB. Please change this password when possible for increased security. The master passcode for the shareware version is 4FP39QN6V. Enter this passcode in place of the normal password, and you can lock out the normal password, or change it in case a user forgets theirs. THE IMPORT FUNCTION ═══════════════════ This feature allows you to enter attendance occurrences into ATTEND from an external program. Whether it be from a spreadsheet, word processor, or another timeclock program, ATTEND will accept ASCII text type files for input, and import resulting attendance incidents to the ATTEND database. A copy of the import data can also be placed into the employee's comment file. Version 4.1a has had a new feature added, due to many requests. The Query Dataset for Totals feature (F5) will search the import dataset on one employee, a status type, or all employees, over any date range in the same calendar year, and report the hours worked for each employee, in addition to their unadjusted pay. The results are displayed in a scrolling window onscreen, and in the registered version, can be saved to ASCII text file, and printed. Some features are reserved for the registered version. The Import utility expects a certain format for input. The text file records should be arranged in this order: Badge/ID# (8 chars maximum) Time of occurrence (8 chars in the format HH:MM:SS) Type of Occurrence (see below) (one blank line between each occurrence) Spaces should be inserted between each occurrence in this import text file. For example, the next few lines show an example: 12345 07:05:00 1 678 08:30:00 3 7654 16:00:00 2 The first group shows employee #12345 clocking in at 7 a.m., and the second group shows employee #678 clocking out to their first break at 8:30 a.m. The last group shows employee #7654 clocking out for the day at 4 p.m. Note that times are expressed in 24 hour format, and all digits are used, even if zero. The types of occurrences that the import program is set to record are as follows: Numeric Code: Meaning: ------------- -------- 1 Clock in for work 2 Clock out from work 3 Clockout to first break 4 Clockin from first break 5 Clockout to Lunch 6 Clockin from Lunch 7 Clockout to second break 8 Clockin from second break 9 Other The 'Other' fields are specified on two of the three timeclock screens. For more detailed information on their meaning, please register your copy of Attend. Full, printed documentation is provided only to registered users. Before actually importing text, you must set up the import utility dataset. This dataset contains normal clock times, work week hours, and so forth. It can be accessed from the import menu. Information for all employees in your ATTEND database will need to be entered into the import configuration. Note that there is no date specified for these records. The date for all records in an import text file comes from the file name. The import utility will automatically look for a file using the date as a filename whenever you try to import text. If it does not find one, it will ask for one. For example, on August 1st, 1995, it will look for a file named 08011995.DAT. The file should be placed into the same working directory with Attends' records, be it the current working directory, or the assigned working directory you specified in the program configuration menu. The shareware version of the program will not actually finish sending this data to Attend. This is a reserved feature for those who purchase the program (register). However, the data will remain in the import dataset, and may be sent to ATTEND using the Registered version of the program. You will not lose any data; it will remain in the import dataset. THE TIMECLOCK FUNCTION ══════════════════════ This feature can replace a normal mechanical timeclock, allowing clock punches and attendance information to be more easily recorded and tracked. ASCII text file output is standard; the registered version can also send the clock punch information directly to the Import utility dataset, bypassing the text import step and saving time. Passwords for each employee can be enabled; the first password for each employee will be taken from the last four digits of the employees' Social Security number, as entered in Attend. Three different clock screens can be used, small/large text and graphical. Passwords can be changed by the administrator, in the event one of your employees forgets their password. Note that employee passwords in the configuration function are visible; take care to only let a responsible party use the function. This function can also be used to automatically set up the timeclock configuration using Attends' master file. For more information on this utility, please register your copy of Attend. Some features reserved for the registered version. ANSWERS TO SOME OF YOUR QUESTIONS ═════════════════════════════════ Currently, there is no pure Windows version of Attend in the works. The author wishes to maintain as much compatibility as possible with all IBM PC and compatible machines. Attend will run on any PC, be it an XT or a Pentium, running on DOS 3 or Windows 95. Let me encourage you to write in with your suggestions for the program. Your feedback is critical in the product improvement process. Attend is not yet a payroll program, though it is coming closer to it! And yes, I do plan to try adding mouse support in a future version, if I can squeeze it into the main module code. Some features of Attend have been implemented in a general way. Some of you have written in asking for very specific features. If you wish to procure a custom version of Attend, please ask. Otherwise, your suggestions will be taken and converted such that the average user can make use of them. I have absolutely no problem with changing the title on the main menu screen, for those of you setting up this program for a client's business. I'd like to keep the Attend title up there, but the rest of it is up to you. Should you wish the client's business name up there, I can find another place to put the program title. Keep in mind that I rebuild each and every one of the registered versions, as your unique master passcodes are all hard-coded into the program. So, it's not a big deal to add a line of text, and I wouldn't mind changing the signoff screen, either. Random jokes are out though, there just isn't room! Attend is written and compiled in MicroSoft QuickBasic, the last great DOS compiler MS made before Bill decided we need Visual Basic. Don't let this fact fool you though, QuickBasic makes some *very fast* programs, and it works on anything. Try it and see. The source code is not available for purchase. I have a hard time setting a price on a fourth year project, something like 15,000+ lines of code, and well over a couple thousand hours time invested. If you have a programming question though, feel free to ask. Let me apologize if the reserved features cause you some chagrin. Attend is most certainly a labor of love, but one can't expect an author to give away everything he makes for free. Speaking of which... REGISTRATION AND PRODUCT SUPPORT ════════════════════════════════ Please see the file REGISTER.TXT for a registration/purchase form for ATTEND version 4.1a. Many hundreds of hours went into the development and preparation of ATTEND. ShareWare is a type of distribution, not a type of software. You may 'Try out' a shareware program for 30 days, before paying for it - this is the main feature of ShareWare. Most ShareWare programs are equal in quality - if not superior - to their commercially distributed counterparts. In addition to being able to try out a program before purchasing it, you save on the cost of the program, as the author saves on costs associated with commercial distribution. Thus, ShareWare benefits both the user and the author alike, cutting the middleman and his costs. The main menu of ATTEND will report the first date the program is used. This is a reminder to register your copy in 30 days, should you be using the program at that time. Please do not continue to use ATTEND beyond 30 days without purchasing the registered version. Only by legally purchasing ATTEND can the author be convinced to continue to develop and enhance the program. The program will not cease to function at 30 days - it is not expireware. However, a few features are reserved for the registered version, as is full program documentation. ATTEND is *not* free software. I regret that in addition to the printed manual as a registration incentive, that I have reserved parts of the new 'Additional Features' for people who pay for (register) ATTEND. You can try out the TimeClock and Import features, but they will not per- form all of their functions in the shareware distribution version. WHAT YOU RECEIVE FOR REGISTERING ════════════════════════════════ Registering ShareWare usually brings the purchaser additional benefits, such as documentation, program support, enhanced or updated versions, and discounts on future versions of the program. These are all true for ATTEND. This file is not the full documentation for Attend. It is only a short summation, distributed with the shareware version. Upon your registration, you will receive by return mail the complete, printed 50+ page documentation package for the program (not found in the shareware version), a new copy of ATTEND with all reserved features fully functional (including a unique master passcode), full support by Email, telephone, and post mail, and a 50% discount on future upgrades. WHAT IF ATTEND DOESN'T MEET MY NEEDS? ═════════════════════════════════════ If you find that the program does not meet your needs, no problem. Simply delete it from your computer system. If you would be so kind as to send a short Email message to the author, your review of ATTEND would help to further develop the program. Though full support is only granted to registered users, if you experience a problem running ATTEND, please write me and let me know what happened. Contact the author by Email or post, concerning customized versions of ATTEND for your particular business. Write the author a note with your question or suggestion, and if it fits the purpose of the program, it may be implemented in a future version. WHAT ABOUT PROGRAM SUPPORT? ═══════════════════════════ Registered users of ATTEND receive full product support. This means if you have a problem with the program, have a special need that is simple to implement, or don't understand something, your question or need will be taken care of by the author. This also means that if necessary, a new program executable will be rebuilt for you and sent by Email. The author stands behind his work, and you may rest assured that your purchase of this program is not the last you will hear from *this* author. The author can't support UNregistered users, and disclaims any and all liability for any mishaps, errors, omissions, or any other problems that may arise out of the use of the program, for the ShareWare version. That's fair, isn't it? ;-) ────────────────────────── Thank you for trying out ATTEND! ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ATTEND V4.1a Employee Attendance Tracking Database Program Registration ║ ║ ║ ║ Send completed registration form along with check or money order for ║ ║ $30 (U.S.) to: ║ ║ ║ ║ (For currently registered users, the upgrade fee is $15.) ║ ║ ║ ║ Robert J. Manning, PO Box 2011, Lomita, CA 90717 (Current 8/95) ║ ║ ║ ║ Email inquiries may be sent to the following addresses: ║ ║ ║ ║ America Online: RobertM782 Compuserve: 76022,1630 ║ ║ Internet: RobertM782@AOL.COM ║ ║ ║ ║ Visit the SBCA Web Page (includes a link to the authors' FTP site) at: ║ ║ http://users.aol.com/robertm782/private/sbcapage.htm ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝